{% extends "documentation/docs_base.html" %}

{% block doc_title %}Products{% endblock %}

{% block doc_content %}
  <div class="body">
    <h1 id="policy">Products on Crash Stats</h1>
    <p>
      The Socorro crash ingestion pipeline handles incoming crash reports for
      Mozilla products. Crash reports are collected, processed, and
      available for search and analysis using the Crash Stats web site.
    </p>
    <p>
      Incoming crash reports have a <code>ProductName</code> which specifies
      which product the crash report came from.
    </p>
    <p>
      Incoming crash reports for Firefox desktop have
      <code>ProductName</code> as <code>Firefox</code>. The Firefox crash
      reporter sets this using the value of <code>MOZ_APP_BASENAME</code> in
      <code>browser/confvars.sh</code>.
    </p>
    <p>
      Incoming crash reports for GeckoView-based products have <code>ProductName</code> set to
      the app name argument when setting up <code>MozillaSocorroService</code>.
      See the
      <a href="https://github.com/mozilla-mobile/android-components/blob/master/components/lib/crash/README.md#sending-crash-reports-to-mozilla-socorro">documentation for MozillaSocorroService</a>
      for details.
    </p>
    <p>
      Socorro only accepts crash reports from supported products. Crash
      reports for products that Socorro doesn't recognize are rejected.
    </p>

    <h1 id="collection">Collection of crash report data</h1>
    <p>
      Crash report data falls under category 4 of our
      <a href="https://wiki.mozilla.org/Firefox/Data_Collection">data collection categories</a>
      because it contains information about the state of the application
      when it crashed including memory dumps.
    </p>
    <p>
      Collection of this data should default to off and requires user notice
      for consent, share what will be sent, and allow a user to decline
      sending.
    </p>

    <h1 id="requestaccess">How to request a new product on Socorro</h1>
    <p>
      To request a new product be added, please file
      <a href="https://bugzilla.mozilla.org/enter_bug.cgi?format=__standard__&product=Socorro&component=General&short_desc=new%20product:%20YOURPRODUCT">a bug report</a>.
    </p>
    <p>
      In the bug report, please specify the following things:
    </p>
    <ol>
      <li>The name of the product as you want it to show up in the Crash Stats
          web interface.</li>
      <li>The <code>ProductName</code> value in the crash reports.</li>
    </ol>
    <p>
      If you have any questions or additional needs, please email us.
    </ol>
  </div>
{% endblock %}
